home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 1 / Precision Software Applications Silver Collection Volume One (PSM) (1993).iso / games / egavga / cmagi163.exe / README.1ST < prev    next >
Text File  |  1992-01-15  |  5KB  |  145 lines
  1.  
  2.  
  3.                ██▒▒██▒▒██▒▒██▒▒██▒▒
  4.                ▒▒██▒▒██▒▒██▒▒██▒▒██             ChessMAGIC!
  5.                ██▒▒██▒▒██▒▒██▒▒██▒▒               (c)1991
  6.                ▒▒██▒▒██▒▒██▒▒██▒▒██        Knightware/Bud Bradley
  7.                ██▒▒██▒▒██▒▒██▒▒██▒▒
  8.                ▒▒██▒▒██▒▒██▒▒██▒▒██         in association with
  9.                ██▒▒██▒▒██▒▒██▒▒██▒▒             Decibel BBS
  10.                ▒▒██▒▒██▒▒██▒▒██▒▒██
  11.  
  12.  
  13.                                    README.1ST
  14.                                        by
  15.                                    Tom Brady
  16.  
  17.  
  18.                     Thanks for trying ChessMAGIC! on your BBS! 
  19.  
  20.     In order for ChessMAGIC! to run, you MUST include on your command line 
  21.     certain parameters.  The proper procedure is detailed in CMAGIC.DOC, so 
  22.     please take a moment to read this documentation. 
  23.  
  24.     For those of you who hate to read docs, TEST_IT.BAT will bring 
  25.     ChessMAGIC! up using the GENERIC.SYS file.  This method of operation 
  26.     causes ChessMAGIC! to prompt for a name entry.  This method of operation 
  27.     is NOT recommended, but does provide you with a quick look before using 
  28.     properly with your particular BBS type. 
  29.     
  30.     The following BBS user file formats are DIRECTLY SUPPORTED by the current 
  31.     version of ChessMAGIC!:
  32.     
  33.            door.sys     - WildCat! v3.x, GAP v5.x, Generic & others 
  34.            callinfo.bbs - WildCat! v2.x 
  35.            pcboard.sys  - PCBoard v14.5 & v12.0
  36.            dorinfox.def - RBBS, QBBS & others
  37.            generic.sys  - A simple user system file that ChessMAGIC! can 
  38.                           utilize. 
  39.  
  40.        Sample DOOR.BAT for systems using DOOR.SYS format:
  41.  
  42.            d:
  43.            cd \doors\cmagic
  44.        *   cmagic DRIVE\PATH\door.sys
  45.  
  46.        *   NOTE:  If not in your default directory where ChessMAGIC! is run, 
  47.                   you MUST specify the DRIVE\PATH to your system's user file!
  48.  
  49.  
  50.                              ======================= 
  51.                                    CMPROTO.DAT 
  52.                              ======================= 
  53.  
  54.     CMPROTO.DAT will contain the file transfer protocols you wish to make 
  55.     available to your users.  You may list up to 10 protocols, one per line.  
  56.     Following the protocol drive\path\program information, you will include 
  57.     a comma, then a short protocol description of up to 25 characters. 
  58.  
  59.     ChessMAGIC! will pass two parameters: 
  60.  
  61.              %1 = port number 
  62.              %2 = file name 
  63.  
  64.        For several popular protocols, port numbers are defined in the 
  65.        environment by using the SET command (e.g. SET DSZPORT=2 for DSZ, 
  66.        tells it to use port 2 -- DSZ defaults to using port 1).  However, 
  67.        you may specify this parameter in your protocol batch file (or 
  68.        alias), if you wish. 
  69.  
  70.        The file name being sent to your users by ChessMAGIC! will be 
  71.        passed as the %2 parameter. 
  72.  
  73.     The following examples will give you an idea of how this file's contents 
  74.     may vary according to your own system configuration: 
  75.  
  76.        1.  Using an alias (e.g. cm_z) as configured in 4DOS, only it and 
  77.            the description are necessary. 
  78.  
  79.               cm_z,Zmodem 
  80.  
  81.            Your cm_z alias could be defined as: 
  82.  
  83.               alias cm_z `dsz sz %%2` 
  84.  
  85.        2.  The complete command line specified, calling your protocol 
  86.            directly: 
  87.               
  88.               dsz port %1 sz %2,Zmodem (DSZ MobyTurbo) 
  89.  
  90.        3.  The full drive\path and BAT extent are specified: 
  91.  
  92.               c:\util\z.bat,Zmodem via DSZ MobyTurbo 
  93.  
  94.            Your z.bat definition could be as simple as: 
  95.  
  96.               dsz sz %2 
  97.  
  98.        4.  Z.BAT is found within the normally specified PATH, so the 
  99.            command line can be abbreviated: 
  100.        
  101.               z,Zmodem   MobyTurbo via DSZ 
  102.  
  103.     As you can see, it all depends on your own system requirements. 
  104.  
  105.  
  106.                              ======================= 
  107.                                     ATTENTION 
  108.                                      Sysops! 
  109.                              ======================= 
  110.     
  111.  
  112.     For those of you running a system not directly supported by ChessMAGIC!, 
  113.     use QKDOOR2F.EXE by Chris Hall.  This utility converts your user files
  114.     from one format to another, enabling you to use ChessMAGIC! at once, with
  115.     little additional effort.  If you have trouble locating this utility,
  116.     call Decibel BBS.
  117.     
  118.     Qkdoor is easy to run and doesn't even need to be configured (you can 
  119.     delete the QKDOOR.CTL file -- it isn't required).  Run it where your user 
  120.     information files for the required node are located, using a simple 
  121.     command line: 
  122.     
  123.          qkdoor wwiv d:\cmagic\gap         {WWIV} 
  124.     
  125.     This will read in the user file data (in default area when run) and 
  126.     generate the DOOR.SYS file in your CMAGIC system directory (use whatever 
  127.     path suits your system setup). 
  128.      
  129.     After conversion to DOOR.SYS format, your ChessMAGIC! command line would 
  130.     be as simple as:
  131.     
  132.          cmagic door.sys
  133.     
  134.  
  135.     An example DOOR.BAT file when using this converter follows: 
  136.     
  137.          qkdoor wwiv d:\cmagic\gap 
  138.          d:
  139.          cd\cmagic
  140.          cmagic door.sys 
  141.     
  142.     
  143.     If you have trouble, PLEASE CONTACT US! 
  144.  
  145.